home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 3.iso / dist / fw_qt3.idb / usr / freeware / Qt / INSTALL.z / INSTALL
Text File  |  2002-04-08  |  4KB  |  127 lines

  1.               INSTALLING Qt FOR X11
  2.  
  3.  
  4. You may need to be root, depending on the permissions of the directories
  5. where you choose to install Qt.
  6.  
  7.  
  8. 1.  Unpack the archive if you have not done so already:
  9.  
  10.     cd /usr/local
  11.     gunzip qt-x11-3.0.3.tar.gz    # uncompress the archive
  12.     tar xf qt-x11-3.0.3.tar    # unpack it
  13.  
  14.     This creates the directory /usr/local/qt-3.0.3 containing the
  15.     files from the main archive.
  16.  
  17.     Rename qt-3.0.3 to qt (or make a symlink):
  18.  
  19.     mv qt-3.0.3 qt
  20.  
  21.     The rest of this file assumes that Qt is installed in /usr/local/qt.
  22.  
  23.  
  24. 2.  Set some environment variables in the file .profile (or .login,
  25.     depending on your shell) in your home directory. Create the
  26.     file if it is not there already.
  27.  
  28.     QTDIR           - the directory in which you're building Qt
  29.     PATH           - to locate the moc program and other Qt tools
  30.     MANPATH        - to access the Qt man pages
  31.     LD_LIBRARY_PATH       - for the shared Qt library
  32.  
  33.     This is done like this:
  34.  
  35.     In .profile (if your shell is bash, ksh, zsh or sh), add the
  36.     following lines:
  37.  
  38.     QTDIR=/usr/local/qt
  39.     PATH=$QTDIR/bin:$PATH
  40.     MANPATH=$QTDIR/doc/man:$MANPATH
  41.     LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH
  42.  
  43.     export QTDIR PATH MANPATH LD_LIBRARY_PATH
  44.  
  45.     In .login (in case your shell is csh or tcsh), add the following lines:
  46.  
  47.     setenv QTDIR /usr/local/qt
  48.     setenv PATH $QTDIR/bin:$PATH
  49.     setenv MANPATH $QTDIR/doc/man:$MANPATH
  50.     setenv LD_LIBRARY_PATH $QTDIR/lib:$LD_LIBRARY_PATH
  51.  
  52.     After you have done this, you will need to login again, or
  53.     re-source the profile before continuing, so that at least $QTDIR
  54.     and $PATH is set.  The installation will give an error message and
  55.     not proceed otherwise.
  56.  
  57.     On AIX set LIBPATH and on HP-UX set SHLIB_PATH instead of LD_LIBRARY_PATH.
  58.  
  59.  
  60. 3.  Install your license file as $HOME/.qt-license.
  61.     For the free edition, you do not need a license file.  For Professional
  62.     and Enterprise editions, install your license file as described in your
  63.     distribution.
  64.  
  65.  
  66. 4.  Building.
  67.  
  68.     This step compiles the Qt library, and builds the example programs,
  69.     the tutorial, and the tools (eg. the Designer).
  70.  
  71.     Type:
  72.  
  73.     ./configure
  74.  
  75.     This will configure the Qt library for your machine. Note that
  76.     GIF support is turned off by default. Run ./configure -help
  77.     to get a list of configuration options. Read PLATFORMS for a
  78.     list of supported platforms.
  79.  
  80.     To create the library and compile all examples and the tutorial:
  81.  
  82.     make
  83.  
  84.     If your platform or compiler is not supported, please contact us at
  85.     qt-bugs@trolltech.com so that we can assist you.  If it is supported
  86.     but you have problems, see http://www.trolltech.com/platforms/
  87.  
  88.  
  89.     At this point you have binaries created in $QTDIR (eg. $QTDIR/lib/
  90.     contains libqt.so). If, however, you would like to have your Qt
  91.     installed in a non-local installation you can run configure with
  92.     options splitting Qt into different areas for example:
  93.  
  94.         ./configure -libdir /usr/local/lib -bindir /usr/local/bin -headerdir /usr/local/include/qt
  95.  
  96.     Then after a successfull make you can:
  97.  
  98.         make install 
  99.  
  100.     This will install Qt onto your machine, with these destination options
  101.     you will able to segment Qt into different places on your system
  102.     (please see ./configure -help for the install option section for more
  103.     help). If you choose to install Qt like this, remember you must set
  104.     your LD_LIBRARY_PATH to match your -libdir and your QTDIR to your
  105.     -headerdir (as described in 2 above).
  106.  
  107.  
  108. 5.  In very few cases you may need to run /sbin/ldconfig or something
  109.     similar at this point if you are using shared libraries.
  110.  
  111.     If you have problems running the example programs, e.g. messages like
  112.  
  113.      can't load library 'libqt.so.3'
  114.  
  115.     you probably need to put a reference to the qt library in a
  116.     configuration file and run /sbin/ldconfig as root on your system.
  117.     And don't forget to set LD_LIBRARY_PATH as explained in 2) above.
  118.  
  119.  
  120. 6.  The online HTML documentation is installed in /usr/local/qt/doc/html/
  121.     The main page is /usr/local/qt/doc/html/index.html
  122.     The man pages are installed in /usr/local/qt/doc/man/
  123.  
  124.  
  125.  
  126. That's all.  Qt is now installed.
  127.